docs: Tweak GdkToplevel docs

diff --git a/gdk/gdktoplevel.c b/gdk/gdktoplevel.c
index 38a527c1ba2c9e13a17b046fcba04c9af48dbfca..34328db10df350f14910c42e0a3a83bde8ae7888 100644 (file)
--- a/gdk/gdktoplevel.c
+++ b/gdk/gdktoplevel.c
@@ -30,8 +30,14 @@
  * SECTION:gdktoplevel
  * @Short_description: Interface for toplevel surfaces
  * @Title: Toplevels
+ * @See_also: #GdkSurface, #GdkPopup
  *
  * A #GdkToplevel is a freestanding toplevel surface.
+ *
+ * The #GdkToplevel interface provides useful APIs for
+ * interacting with the windowing system, such as controlling
+ * maximization and size of the surface, setting icons and
+ * transient parents for dialogs.
  */
 
 G_DEFINE_INTERFACE (GdkToplevel, gdk_toplevel, GDK_TYPE_SURFACE)